home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / dev / gui / gui4cli.lha / Gui4Cli / Docs / Changes < prev    next >
Encoding:
Text File  |  1999-12-02  |  7.2 KB  |  185 lines
  1.  
  2.   ================================================================
  3.   === VERSION 3.8 CHANGES ------------------------------------->>>
  4.   ================================================================
  5.  
  6.   New Events :
  7.  
  8. - xTEXTBOX  L T W H Title Text
  9.   A very versatile gadget which allows you to easily display text
  10.   justified within the bounds of a box. Through attributes you
  11.   can change the appearance of the box & text in almost any way.
  12.  
  13. - xONHELP ON|OFF|AUTO
  14.   This gives you more control over displaying of help messages.
  15.   > If declared, the help messages will NOT appear on the screen's 
  16.     title bar, but instead, this event will happen. You can get the
  17.     gadgets'GADHELP text with $$HELP.TEXT and id with $$HELP.GADID
  18.     and show them any other place you want.
  19.   > You can set this gadget to ON, OFF or AUTO
  20.     ON, OFF : sets the help state for this gui only
  21.     AUTO    : lets the gui be controlled globally together with all 
  22.               the other guis (through the HELP key).
  23.   > You can also give it a GADID and SETGAD it to ON|OFF|AUTO.
  24.  
  25. - xONCLICK
  26.   Will happen whenever the user clicks in any part of the window
  27.   which is not taken up by a gadget. Note that if you double-click
  28.   you'll get one xOnClick and one xOnDoubleClick (if both defined).
  29.  
  30.   New Commands :
  31.  
  32. - SETPOINTER GuiFile DEFAULT/HIDE/#Image
  33.   Will allow you to change the pointer which will be used whenever 
  34.   the given gui's window is active. You can set an image as a pointer
  35.   or use the preferences or hide it.
  36.  
  37. - GADREDRAW GuiName LeftGad TopGad RightGad BottomGad Offset
  38.   This provides the best redrawing. It works like PartRedraw
  39.   but you give the GadIDs of the gadgets whose borders will be
  40.   used to calculate the area to erase. "Offset" the number of
  41.   pixels you want these sizes to be shifted by.
  42.  
  43. - PALETTE LOAD|SAVE|SET|GET|REMAP Source Destination
  44.   will allow to do just about anything involving palettes. See the
  45.   guide for explanation of the arguments.
  46.  
  47. - SET ImDEV/ImVOL/ImASN/ImDIR/ImFILE ImageAlias
  48.   Will set the images that will be displayed in Dir LVs, for the 
  49.   respective items. So <SET ImDEV mydevimage> will cause the image
  50.   named "mydevimage" (which must have been loaded first with 
  51.   LoadImage) to be displayed in front of every Device name in the 
  52.   Device list. Looks great :)
  53.  
  54. - IMAGES in Listviews!
  55.   The way to do this is to state the image Alias (ie the name you 
  56.   gave it when you loaded it with the "LoadImage" command), anywhere
  57.   in a line of text, starting with the ESCAPE character and "\",
  58.   then the image name, then another "\".
  59.  
  60. - FULLPATH is a new very usefull keyword for the EXTRACT command.
  61.   It will try and locate a file in your path and return the full
  62.   path & filename or "" if the file is not found.
  63.   > prog = MyProName
  64.   > Extract prog FULLPATH prog
  65.  
  66. - SET LVSORT NORMAL|DATE|SIZE|EXTENTION will globally set the method 
  67.   by which Directory listviews will sort their list. If you give DATE
  68.   for example, the most recent dirs/files will go to the top.
  69.  
  70. - SET MARGINS Side/Top/TopDistance - globally set title margins & 
  71.   distance of font from the gadgets they are attached to. (def=5/10/1)
  72.  
  73. - SET TBMARGINS Horizontal/Vertical - globally set xTEXTBOX inner margins
  74.   ie the distance the text is from the side of the box. (def=5/4)
  75.  
  76.   Internal variables :
  77.  
  78. - Variables for xOnHelp event (see above)
  79.   $$HELP.TEXT and $$HELP.GADID
  80.  
  81. - Variables for : INFO FILE FileName
  82.   $$FILE.LENGTH  - file length
  83.   $$FILE.BLOCKS  - The number of blocks it occupies
  84.   $$FILE.DATE    - date it was last changed
  85.   $$FILE.DAY     - day last changed
  86.   $$FILE.TIME    - time last changed
  87.   $$FILE.TYPE    - either DIR or FILE
  88.   $$FILE.COMMENT - file comment (if any)
  89.  
  90. - Variables for : INFO VARIABLE VarName
  91.   $$VAR.LENGTH   - length of variable (characters)
  92.  
  93. - $$GAD.IL $$GAD.IT 
  94.   will give you the 0-based Left & Top position of the gadget.
  95.  
  96. - These are used in the guis:Gui4Cli.gc gui.
  97.   G4C.LVFILL      1=Draw the listview fill-in box at bottom, 0=don't
  98.   G4C.NOVOL       1=Do not show volumes in device list, 0=Show them
  99.   G4C.MARGINS     Returns 3 numbers "SideMargin TopMargin OffSet" 
  100.   G4C.TBMARGINS   Returns 2 numbers (xTextBox margins) "Horz Vert"
  101.   G4C.LVSORT      0=Normal, 1=Date, 2=Ssize, 3=Extension
  102.  
  103.   Attributes (ATTR & SETATTR) :
  104.  
  105. - Attributes for xTEXTBOX:
  106.   TBSTYLE apen/bpen/drawmode/Justify
  107.   TBOX    apen/bpen/bgpen/border/recess
  108.  
  109. - TITLE  apen/bpen/drawmode/HorzJustify/VertJustify/title
  110.   Attaches a fancy, highly customizable title to any type of gadget
  111.   or graphic.
  112.  
  113. - RESIZE  LTWH      (example: Resize 0021)
  114.   Super cool new attr which lets you describe exactly how a gui 
  115.   should resize itself. The argument is a mask, each digit is one 
  116.   of Left, Top, Width, Height and can be :
  117.   0 = no resize,
  118.   1 = Proportional resize (this is the Normal resize) 
  119.   2 = Delta resize (add the full length change)
  120.   3 = Max resize (the sum of both (1) and (2) above)
  121.  
  122. - TIPOS Position
  123.   Will set the cursor position of a TextIn type gadget
  124.  
  125. - FRAME FrameTypeMask(type|recessed)
  126.   Will draw a frame around the given gadget. The frame is given as
  127.   a mask of 2 numbers :
  128.   1st number is type:  1=Button, 2=Ridge, 3=IconDrop
  129.   2nd number is :      0=Out(normal), 1=Recessed.
  130.  
  131.   Improvements :
  132.  
  133. - Better resizing and font sensitivity.
  134.   That's what better have happened after all the thousands of
  135.   hours I spent going over the relevant code..
  136.  
  137. - You can now place gadgets over graphics. Before, the graphics 
  138.   were drawn over the gadgets. Now they are drawn below them (I
  139.   add them after the window has opened).
  140.  
  141. - The COPY command (also LVCOPY and ACTION COPY) will now check if 
  142.   the destination file exists and is more recent than the source. 
  143.   If yes, it will warn you (as is done by Dir-Opus, Windows etc) 
  144.   and ask you if it should proceed (with Yes/Yes to all/No etc..)
  145.  
  146.   Also, the date of the new file is now set to the same as the
  147.   old. There is better error/abort checking as well..
  148.  
  149. - ASL requesters and ezreqs will now open on the frontmost 
  150.   screen, if the window that called them is not open, or, if
  151.   the font screen is not public, on the workbench.
  152.  
  153. - xLISTVIEW gadgets do not resize properly, because gadtools
  154.   insists on limiting their height to a multiple of the font
  155.   height. I have added a drawing routine which will fill in the
  156.   remmaining space at the bottom with a beveled box.
  157.   This can be disabled globally with <SET LVFILL OFF>
  158.  
  159.   Bugs & Fixes :
  160.  
  161. - The LAUNCH command now knows about your search paths, so
  162.   you can launch say 'fsearch' and not 'guis:c/fsearch'
  163.  
  164. - The $$FILE internal var used in the ACTION/LVACTION CLI
  165.   command will now return the full file name & path.
  166.  
  167. - Reworked the window resizing code - it should now behave a
  168.   bit better (I hope..)
  169.  
  170. - Fixed INFO GADGET - it did not set the current gadget.
  171.  
  172. - The wait pointer used will now be the one you set with Prefs.
  173.  
  174. - GuiLoad did not deal well with filenames containing spaces
  175. - GuiScreen #ScreenName .. did not work
  176.   * above 2 bugs appeared in v3.7..
  177.  
  178. - Enhanced DEBUG output somewhat, hey what..
  179.  
  180. - MOVE used to abort when using rename - i.e. when moving a file
  181.   in the same volume - if the destination existed - fixed.
  182.  
  183. - Fixed xOnDoubleClick which did not work..
  184.  
  185.